home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ShareWare OnLine 2
/
ShareWare OnLine Volume 2 (CMS Software)(1993).iso
/
util1
/
filup302.zip
/
FILUPDAT.DOC
< prev
next >
Wrap
Text File
|
1993-02-01
|
4KB
|
105 lines
FILUPDAT.DOC
02/01/93
Introduction:
This program is designed to make updating of files and source code both easier
and quicker. It compares a list of files in a source directory to a list of
files in a destination directory and copies any files that are newer than the
ones found in the destination directory. This is quicker than copying all of
the files with DOS wildcard commands and cleaner than copying everything when
you only want some of the files in the destination area.
The control card file:
FILUPDAT requires an ASCII control card file to be created. The control card
file can consist of five types of records:
comments: These records start with semi-colons or colons or are blank. They
are available primarily for documentating what you're doing.
source directory: These records start with "-S" (or "-F" for "from") followed
by the path to copy the files from. Something like "-SC:\QB45" works fine.
destination directory: These records start with "-D" (or "-T" for "to")
followed by the path to copy the files to. For example, "-DG:\EBBNEW\DOCS".
exclusion specification: These records start with "-X" followed by a space and
one or more filespecs (typically with wildcards). For example, your main file
specification may be "*.*" but you can exclude any QuickBASIC source code files
or object modules by including a "-X *.BAS *.OBJ" statement.
files: These records have a single file name (e.g. "EBBFFILE.WP") that is to
be copied from the source directory to the destination directory. File
specifications can include standard DOS wildcards ("*" and "?"). A comment can
follow the file name provided the comment starts with a colon or a semi-colon.
Source and destination cards can be changed throughout the control card file.
Files are copied based on the most recent source/destination card before the
file card. Changing either the source or destination will reset the exclusion
specification so you have to respecify the -X card if desired.
Also note that cards are processed sequentially. The exclusion specification
card only affects file name card(s) which occur after it.
A sample control card file might look like this:
; Sample file
-SC:\PDOX
-DG:\EBBNEW\PRGS
CUSTOM.SC
ADDRESS.SC
ZIPCODE.SC
; Specifying another source file path; destination still the same
-SC:\MINE
NEWUSER.SC
Invoking the program:
The program accepts several parameters:
FILUPDAT control_file
[ /Flist_file [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ] ]
[ /FULL ] [ /ALL ] [ /Q ] [ /? ]
where:
"control_card_file" is the name of the control card file. It can include path
information if necessary.
"/Flist_file" says you want a text file created which tells you what files were
considered and what happened to each of them. The "list_file" is the name of
the file. This is primarily used for checking the operation of the utility.
The file name can include path information if necessary.
"/OVERWRITE" says that if the list_file already exists, don't prompt before
overwriting it.
"/APPEND" says to append to the list_file if it already exists.
"/-OVERWRITE" says to abort if the output file exists already.
"/OVERASK" says to prompt if the output file exists already. This is the
default.
"/FULL" says to write out full comparison information in the list_file. This is
primarily for debugging purposes but it includes the numeric representation of
the date and time for both the source and destination files.
"/ALL" says to copy all files in your control_card_file regardless of relative
ages.
"/Q" turns off the file-by-file status reporting.
"/?" or "/HELP" or "HELP" gives you syntactical help.
Program written by Bruce Guthrie. Comments and suggestions can be sent to:
Bruce Guthrie
113 Sheffield St.
Silver Spring, MD 20910